home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu725.dms / pu725.adf / BootPic / BootPic.doc next >
Text File  |  1993-11-17  |  13KB  |  279 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                                 BootPicV3.1                                 *
  4. *                                                                             *
  5. *                       © 1991,92,93 by Andreas Ackermann                     *
  6. *                                                                             *
  7. *******************************************************************************
  8.  
  9. CONTENTS:______________________________________________________________________
  10.  
  11.  
  12.        1.  About Freeware
  13.        2.  Introduction
  14.        3.  Installation
  15.        4.  Theory of Operation
  16.        5.  How to select a picture
  17.        6.  Hints
  18.        7.  Restrictions
  19.        8.  Kompatibility
  20.        9.  Possible sources of errors
  21.        10. History
  22.        11. About the programming
  23.  
  24. _______________________________________________________________________________
  25.  
  26. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  27. FREEWARE-CONDITIONS:
  28.  
  29.     BootPic is FREEWARE. You are allowed to copy BootPic as long as the
  30.     following conditions are kept :
  31.  
  32.     o  BootPic mustn't be changed
  33.     o  This DOC-file must be included
  34.     o  BootPic mustn't be spread on disks which are sold for more than 3 US
  35.        Dollars or more than 5 DM !!!
  36.        If you find BootPic on such an expensive disk please tell me !!!
  37.  
  38.     If you like BootPic and if you use it regularly I'd be glad to hear from
  39.     you. Please send me a picture-postcard from your home town/area or some
  40.     money etc ...
  41.  
  42.     If you want to use BootPic as part of a commercial programm, you need my
  43.     written permission.
  44.  
  45.     My Address:            Andreas Ackermann
  46.                            Lorenz-Summa-Str.10
  47.                            95145 Oberkotzau
  48.                            GERMANY
  49.                            Tel.:09286/6399
  50. ________________________________________________________________________________
  51.  
  52.  
  53.                                INTRODUCTION
  54.  
  55. When you've got an OS2.0 or higher Amiga maybe it also happens to you that you
  56. are bored by the black screen that is shown until the workbench comes up. There
  57. are already tools out ( like BootLogo, or IffBoot ) to show a picture during
  58. this time, BUT they come in much too late with their picture. This means, if
  59. you've got a slow AT-Harddisk like I have, you're left with your black screen
  60. for half an eternity.
  61. That's where BootPic comes in: It shows your picture right after you pressed
  62. <Ctrl,leftAmiga,rightAmiga>. The only black spot appears when switching on
  63. your Amiga and booting the first time as there'll be no picture at all.
  64. However it also makes sense to use BootPic without a harddisk.
  65.  
  66.  
  67.                                INSTALLATION
  68.  
  69. It's just too simple ! Copy the contents of the WBStartup drawer in your
  70. WBStartup drawer and the contents of the Prefs drawer into your Prefs drawer.
  71.  
  72.  
  73.                            THEORY of OPERATION
  74.  
  75. BootPic loads an IFF-ILBM file and/or a MED-Module residently into your memory
  76. so that it will survive a reset. So, of course, when starting your system
  77. the first time during a session there's no BootPic installed. But when the
  78. BootPic programm in the WBStartup drawer is executed it first checks if
  79. BootPic is already installed. If not it attempts to load the image/music de-
  80. fined in ENV:bootpic.pref. Otherwise nothing happens. [ Quite sensible. You
  81. certainly don't want to reload the picture any time you're booting your
  82. system, even if you've got a harddisk.]
  83. Next time you perform a reset you'll hopefully see your desired picture.
  84. BootPic doesn't eat any processing time while it is installed as it's only
  85. active during reset time. However the picture you selected remains in chipme-
  86. mory ( as far as I know chipmem is the only place where anything can survive
  87. a reset ! ) all the time so be careful not to load too large pictures.
  88.  
  89.  
  90.                          HOW TO SELECT A PICTURE
  91.  
  92. When you start the BootPicPref programm a window will open with the following
  93. gadgets inside:
  94.  
  95.  o ILBM-File: Complete path of the picture to be shown. After hitting return
  96.               in this gadget BootPic checks if this file can be loaded and
  97.               complains if not.
  98.  o Module:    Complete path of the MED-Module to be played. After hitting
  99.               return in this gadget BootPic checks if this file can be loaded
  100.               and complains if not.
  101.               MED is a Music-programm comparable to SoundTracker. V3.00 of this
  102.               programm is to be found on Fish 476. Please note: When you save
  103.               your Music make sure that you selected 'MED-Module' as output
  104.               format. That's the only one that can be handled by BootPic. (MED
  105.               also loads SoundTrackerModules and then you may save them in the
  106.               MED-Module format !!!)
  107.               As these modules usually are quite large, you may also load modules
  108.               crunched with the PowerPackerV2.3b ( Fish 253 ). Note: Crunched
  109.               Modules may need up to 10s to decrunch at each reset !
  110.  o BootPic active
  111.               this one must be selected if you want a picture to be shown.
  112.  o Play Music this one must be selected if you want a MED-Module to be played
  113.  o No fading  keeps the picture from being faded in.
  114.               Especially useful with HAM or EHB pictures as fading doesn't
  115.               look good at all with them.
  116.  
  117.  o Cancel     Perform no change, leave everything as it was before you
  118.               started BootPicPref.
  119.  o Use        Removes the currently installed BootPic and attempts to load
  120.               everything according to the current settings.
  121.         NOTE: The configuration won't be saved. However the changes remain
  122.               effective until you switch off your Amiga or till you change
  123.               them again. This is because the programm in the WBStartup
  124.               drawer does only check if BootPic is installed but doesn't take
  125.               care of the name of the picture-file as mentioned above !
  126.  o Save       Does the same as 'Use' but additionally saves the current
  127.               configuration to ENVARC:bootpic.pref.
  128.  
  129.  
  130.                                   HINTS
  131.  
  132. If Bootpic fails to load the picture nothing will be made resident.
  133. Note: You *must* use complete pathes for both the picture and the module.
  134. Think of the following case: You've got a picture named 'test.iff' in your
  135. Prefs drawer. If you load it, it's sufficient to simply type in its name
  136. without path, as the Prefs drawer is the current directory. Everything will
  137. do fine till you switch off your Amiga and start a new session. Cause now
  138. it's up to BootPic from the WBStartup drawer to load the picture and now the
  139. current directory is 'WBStartup' where your 'test.iff' can't be found.
  140.  
  141. To remove BootPic temporarily when it's already installed ( for example if
  142. you need some extra memory ) simply deactivate 'BootPic active' and
  143. 'Play Module' and click on 'Use'. If you don't want to get it reinstalled
  144. after the next reset simply click on 'Save'.
  145.  
  146. As you already now, the picture is shown until the Workbench Screen is
  147. opened, which is the case as soon as any application tries to make an output
  148. to the console window. So you should send any output in the startup-sequence
  149. to NIL:. Here's a sample of my startup-sequence:
  150.  
  151. ; $VER: startup-sequence 39.9 (9.8.92)
  152. C:SetPatch >NIL: QUIET
  153. C:Version >NIL:
  154. C:AddBuffers >NIL: DF0: 15
  155.       ...
  156.  
  157.              ********** For experienced users only *********
  158. When you've got lots of programms in your WBStartup drawer it's advisable
  159. to remove them and execute them in the startup-sequence because by the time
  160. the Workbench looks inside the WBStartup drawer your picture already has
  161. disappeared.
  162.  
  163.  
  164.                                 RESTRICTIONS
  165.  
  166. BootPic is only capable of displaying PAL or NTSC pictures. This means
  167. if you've got your Amiga 1200/4000 connected to a VGA-monitor, it won't work.
  168. The new AGA-chipset is only partially supported ( will change in the future):
  169.  
  170.  o none of the new modes is supported.
  171.  o You *may* use up to 256 colors for each resolution, *but*:
  172.    - the width of the picture must be divisible by 32 ( which is the case with
  173.      all standard resolutions like 320*xxx and 640*xxx, but be careful with
  174.      overscan !) as soon as you've got a picture that couldn't be displayed by
  175.      the old chipset.
  176.    - the new colorpalette is not supported which means that the 256 color
  177.      pictures won't appear in the same quality as in Multiview.
  178. However these limitations should be easy to bear as you normally should use
  179. just pictures with 8 to 16 colors as larger ones eat too much memory.
  180.  
  181. After the picture has been shown some time you'll notice it jerking to the top
  182. left corner of the screen. This is due to the execution of IPrefs that adjusts
  183. the 0;0 point of the display and cannot be helped.
  184. Further I found it impossible to get rid of the mousepointer ...
  185. [ I already tried to open a window on the screen and setting a dummy pointer
  186.   but it appeared nevertheless.]
  187.  
  188. NOTE: A bug has been discovered !!! Using packed modules will cause your
  189.       system to crash during booting. I've searched for the reason but found
  190.       no answer ! However, as this feature didn't seem too important to me
  191.       I decided to release this version nevertheless. Will be fixed some day !
  192.  
  193.  
  194.  
  195.                                 KOMPATIBILTY
  196.  
  197.  BootPic installs itself in a «kindly» way, that means that any other resident
  198.  programme won't  be removed, e.g. Guardian, CARD:, but also viruses.
  199.  In the same careful way it removes itself.
  200.  It should run on every Amiga with OS 2.0 or higher.
  201.  
  202.  
  203.                          Possbile SOURCES of ERRORS
  204.  
  205.  Normally a picture that was once installed, stays in memory until you remove
  206.  it or till you switch off your Amiga. But there are some exceptions:
  207.  
  208.   a.)  If you play a game that believes all the memory belongs to itsself, it
  209.        is possible that the memory allocated by BootPic is overwritten.
  210.        Then you won't see the picture any more.
  211.   b.)  Many viruses simply overwrite the reset-vectors. In this case BootPic
  212.        will be gone, too.
  213.   c.)  Some virusdedectors (e.g. ATool) are of the opinion that every resident
  214.        programme is a virus, so BootPic will be removed, too.
  215.  
  216.  If one of these cases should arise, it may be possible, that you get a GURU
  217.  after a reset. If you can't remove it by clicking the left mousebutton,
  218.  switching off the Amiga is the only thing you can do.
  219.  
  220.  If you should meet some trouble when using BootPic with ZKick or any other
  221.  software-based Kickstart loader please tell me !!!
  222.  
  223.  
  224.                                  HISTORY
  225.  
  226.  V1.0 - first release, only Cli-Support
  227.  V1.1 - intuition-interface
  228.  V1.2 - added 'Color-Cycling' and 'Check all Drives'
  229.       - Resident Code and Data MUST be placed in Chip-Mem [only exception:
  230.         internal expansions of 512k at location $C00000 (e.g. I've this one)].
  231.         Now it uses Chip-Mem. Sorry, I didn't know about this limitation.
  232.       - There was some code that caused BootPic to guru on the A500 Plus with
  233.         OS 2.0 after displaying the picture. Now it works ...
  234.       - Fixed one bug that caused serious errors when loading IFF-files with
  235.         more than 32 colors saved ( like the HAM-Demo-pics of DPaintIV ).
  236.       - Brushes now are handled correctly.
  237.  V2.0 - MED-Module support
  238.  V2.0b- Delay-support
  239.  V2.0c- patch for Kick 1.3
  240.  V2.0d- now should run with MultiKickstartBoards
  241.  V2.1 - included bootselector for Kick1.2/1.3
  242.  V3.0 - user interface completely rewritten for OS 2.0 and modified its be-
  243.         haviour to be useful with harddisks. The old replacement for the
  244.         'Workbench-Hand' no longer is possible. Not officially released.
  245.  V3.1 - Removed some bugs and added the 'No fading' feature.
  246.  
  247.  
  248.                                PROGRAMMING
  249.  
  250.  BootPic was written with the Devpac 2.14D - Assembler in combination with
  251.  EZAsm of Joe Siebenmann.
  252.  Many thanks go to JM Forgeas for the wonderful editor AZ V1.50.
  253.  Thanks Markus Herpich who provided me his brandnew A500+ for a whole
  254.  afternoon.
  255.  
  256.  The code for playing the sound was written by Teijo Kinnunen.
  257.  I took it from the MEDV3.0 package distributed on Fish 476.
  258.  [Files: loadmod.i and modplayer.i]
  259.  The decrunching code is ©opyrighted by Nico François. I took it from Fish 253.
  260.  
  261.  Also greetings to the 17 ( really seventeen, not more [since june 1991] !)
  262.  kind people who sent me the demanded fee or bug reports. Hope there'll be
  263.  more in future ...
  264.  
  265.  Many thanks to Markus Illenseer for his friendly answer. By the time I got
  266.  your letter I had already found out myself how to determine when the
  267.  Workbench opens ! ( I do it the same way like you ! )
  268.  
  269.  I am very thankful for critics, propositions and BUG-reports.
  270.  [ If you write, please use special stamps if possible, my Grandpa is a
  271.    stamp-collector. Thanks. ]
  272.  
  273.                          ENJOY !
  274.  
  275.   Oberkotzau, october 28th 1993               Andreas Ackermann [*10.07.1974]
  276.   [ excuse my mistakes !!! ]
  277.  
  278.  
  279.